backlinks

Defines a collection of backlinks that represents the inverse relationship between two Realm models. Any direct relationship, one-to-one or one-to-many, can be reversed by backlinks.

You cannot directly add or remove items from a backlinks collection. The collection automatically updates itself when relationships are changed.

backlinks on a one-to-one relationship:

class Town {
 var county: County? = null
}

class County {
 val towns: RealmResults<Town> by backlinks(Town::county)
}

backlinks on a one-to-many relationship:

class Parent {
 var children: List<Child>? = null
}

class Child {
 val parents: RealmResults<Parent> by backlinks(Parent::children)
}

Querying inverse relationship is like querying any RealmResults. This means that an inverse relationship cannot be null but it can be empty (length is 0). It is possible to query fields in the class containing the backlinks field. This is equivalent to link queries.

Because Realm lists allow duplicate elements, backlinks might contain duplicate references when the target property is a Realm list and contains multiple references to the same object.

Return

delegate for the backlinks collection.

Parameters

Returns a BacklinksDelegate that represents the inverse relationship between two Realm models.

Reified convenience wrapper for backlinks.